package com.ruoyi.newSystem.service;


import com.ruoyi.common.core.domain.permission.vo.role.RoleCreateReqVO;
import com.ruoyi.common.core.domain.permission.vo.role.RoleExportReqVO;
import com.ruoyi.common.core.domain.permission.vo.role.RolePageReqVO;
import com.ruoyi.common.core.domain.permission.vo.role.RoleUpdateReqVO;
import com.ruoyi.common.core.domain.entity.RoleDO;

import javax.validation.Valid;
import java.util.Collection;
import java.util.List;
import java.util.Set;

/**
 * 角色 Service 接口
 *
 * @author 后台源码
 */
public interface RoleService {

    /**
     * 创建角色
     *
     * @param reqVO 创建角色信息
     * @param type  角色类型
     * @return 角色编号 long
     */
    Long createRole(@Valid RoleCreateReqVO reqVO, Integer type) throws Exception;

    /**
     * 更新角色
     *
     * @param reqVO 更新角色信息
     */
    void updateRole(@Valid RoleUpdateReqVO reqVO) throws Exception;

    /**
     * 删除角色
     *
     * @param id 角色编号
     */
    void deleteRole(Long id) throws Exception;

    /**
     * 更新角色状态
     *
     * @param id     角色编号
     * @param status 状态
     */
    void updateRoleStatus(Long id, Integer status) throws Exception;

    /**
     * 设置角色的数据权限
     *
     * @param id               角色编号
     * @param dataScope        数据范围
     * @param dataScopeAccessIds 部门编号数组
     */
    void updateRoleDataScope(Long id, Integer dataScope, Set<String> dataScopeAccessIds);

    void updateRoleDataSet(Long id, String dataScopeDeptIds);


    /**
     * 获得角色
     *
     * @param id 角色编号
     * @return 角色 role
     */
    RoleDO getRole(Long id);


    /**
     * 获得角色列表
     *
     * @param ids 角色编号数组
     * @return 角色列表 role list
     */
    List<RoleDO> getRoleList(Collection<Long> ids);


    /**
     * 获得角色列表
     *
     * @param statuses 筛选的状态
     * @return 角色列表 role list by status
     */
    List<RoleDO> getRoleListByStatus(Collection<Integer> statuses);

    /**
     * 获得所有角色列表
     *
     * @return 角色列表 role list
     */
    List<RoleDO> getRoleList();

    /**
     * 获得角色分页
     *
     * @param reqVO 角色分页查询
     * @return 角色分页结果 role page
     */
    List<RoleDO> getRolePage(RolePageReqVO reqVO);

    /**
     * 获得角色列表
     *
     * @param reqVO 列表查询
     * @return 角色列表 role list
     */
    List<RoleDO> getRoleList(RoleExportReqVO reqVO);

    /**
     * 判断角色编号数组中，是否有管理员
     *
     * @param ids 角色编号数组
     * @return 是否有管理员 boolean
     */
    boolean hasAnySuperAdmin(Collection<Long> ids);

    /**
     * 校验角色们是否有效。如下情况，视为无效：
     * 1. 角色编号不存在
     * 2. 角色被禁用
     *
     * @param ids 角色编号数组
     */
    void validateRoleList(Collection<Long> ids) throws Exception;


    /**
     * 获取这个角色所有的权限范围（包括faq ,知识库）
     *
     * @return
     */
    List<String> getDataScope();

    /**
     * 根据用户id获取用户角色
     *
     * @param userId 用户id
     * @return 用户权限集合
     */
    List<RoleDO> getRolesByUserId(Long userId);
}
